home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / BUS / Graf 2.36.sit / Graf ƒ / Readme 2.3.6 < prev    next >
Text File  |  1995-04-15  |  34KB  |  666 lines

  1. Graf 2  v 2.3.6 
  2. Copyright 1995 Ralph S. Sutherland.  
  3. Portions copyright Symantec Corp. (THINK Pascal)
  4. Programmers Editors Package ゥ1993 Rich Siegal.
  5. New fitting routines (my own implementations) based broadly on methods in Numerical Recipies vol 2. 
  6. ゥ1992, W. H. Press, S. A. Teukolsky, W. T . Verrerling and B. P. Flannery, Cambridge Press
  7. (Thanks guys for a great book)
  8.  
  9.     User notes: v 2.3.6
  10.     ------------------
  11.  
  12. Disclaimers: 
  13.  
  14. ・These notes are a guide only, they do not constitute a user manual. 
  15. (There *is* no manual - but this is a mac program we are talking about!)
  16.  
  17. ・The main notes may not be as up to date as the version notes.
  18.  
  19. ・This software is provided 'as is'.  I cannot garantee it is completely perfect or 
  20. accurate and I cannot be responisble for any losses or damages incurred due to inaccuracies
  21. in Graf.  I have taken reasonable measures to test and verify the code, however if 
  22. your life depends on the results (analysing bungee chord stress tests...)
  23. it would naturally be prudent to verify them independently.
  24.  
  25. メIf this program proves useful to anyone out there then fine, if not then that's fine too.モ
  26.  
  27.     New for 2.3.4,5 & 6:
  28.     ------------------
  29.  
  30. ・Version 2.3.6 fixes some unfortunate bugs in 2.3.4 & 5.  Notably the crash on 
  31. startup on a B&W machine!   It also fixes the open file bug that happens when quicktime 
  32. is not installed.  Quicktime is not needed for Graf 2.3.6.
  33.  
  34. Interface and file system overhaul.  (Spring cleaning!)  New Least-Squares features. 
  35. New text search and replace features. This is the last major Graf 2 enhancement. 
  36. (Bugs fixes will continue though.)
  37.  
  38. v2.3.x will probably be the last version of Graf to support B&W only (MC68000) 
  39. machines like the mac plus. :(  However, the planned improvements for the next
  40. version (Graf 3), including 3D plotting (with hidden polygons and RGB lighting) and more 
  41. advanced analysis like FFTs, will not be practical on older machines anyway.  I hope that 
  42. v2.3.x will be around for a while - I will continue to support it even after Graf 3 is released :)
  43. so users with more modest machines and needs can still make plots for free!
  44.  
  45. I don't have access to a Mac Plus anymore, so I would be interested in test
  46. reports and bugs from B&W mac users.
  47.  
  48. ・ New for TEXT windows: Full-featured find and replace.  Includes normal
  49. 'literal' text searches, UNIX style Grep pattern searches (if you have to ask - don't
  50. use it. Otherwise see the excellent Grep documentation with BBedit.) and
  51. Hex String searches - in all TEXT like windows.
  52.  
  53. ・ The word definition (for searching and double clicking) can optionally
  54. include or exclude the +- and . characters.  Inclusion is the default which
  55. is useful for numbers (and has been in all previous versions of Graf), you
  56. can turn if off if you are editing prose and don't want  . characters to be in words.
  57.  
  58. ・ Dialog boxes all updated to the mid 90s.  Keyboard command equivalents for a
  59. most  dialog controls - for the mice/pointer phobic out there.  All except the 
  60. columns dialog which I am still thinking about changing.
  61.  
  62. ・ Reworked file system to use only Directory ids and true volume reference numbers.  Avoid 
  63. WDs altogether.  This should be more reliable, however we are now MFS incompatible - 
  64. no more 128 and 512k 64krom machines. :)
  65.  
  66. ・ More efficient plotting - only draws a new point if it is different from the previous
  67. point at the current resolution.  This makes plots: identical to previous plots, smaller than
  68. previous plots with many close points, faster plotting for dense plots.
  69.  
  70. ・ Improved the 'smoothed' curve algorithm so it now automatically, dynamically, chooses the 
  71. interpolation level to match the curvature.  No more # of interpolation points dialog.
  72.  
  73. ・ New LeastSquares fitting improvements - Normal equations and singular value
  74. decomposition methods may be chosen, different basis functions can be used.
  75.  
  76. ・ New for 2.3.5, non-linear fitting of gaussians with or without  simple background poly
  77. nomials.  Not sure I would trust the error estimates however.  The gaussian fit is 
  78. a sensitive routine and works best on single isolated bell curve data.
  79.  
  80. ・ New for 2.3.5, Simple histogram calculation and trapezoidal integration (so uneven 
  81. data can be handled as easily as even spaced.)
  82.  
  83. ・ Plot axis transforms expanded to include powers, sin, cos ... in addition to simple log.
  84.  
  85. ・ Quitiing menu options - for those times when you just don't want to bother closing
  86. a million windows when quittting...  Use with caution (The Quit and don't save is protected
  87. with an altert, but all the same.)
  88.  
  89. ・ For what it matters: all the update and drawing routines are fully re-entrant and no longer
  90. clobber sensitive globals - this fixes some of the stranger update oddities.
  91.  
  92. Bug Fixes:  Many (as usual)
  93.  
  94. ・ v2.3.5 fixes a couple of color quickdraw problems that happen when run on an SE
  95. or Mac Plus.
  96.  
  97. ・ Fixed a text scrollbar bug were after 'cut'ting off the end of a long text file the 
  98. scroll bar no longer allowe you scroll all the way to the top.
  99. (The bug list would not be complete without a scroll bug... Scrolling should be nigh on perfect now :)
  100.  
  101. ・ Fixed plot/stat progress display to be compatible with system palettes like deskstrip. 
  102. It now no longer punches a hole through it if it lies over the progress bar during
  103. a plot.
  104.  
  105. ・ Gave up on the open multiple file dialog. :(  Now the open command uses a plain vanilla
  106. open single file dialog.  I couldn't fix the crashing bug, it seems to be a fundamental
  107. conflict with th new system that will need a complete rewrite of the open dialog
  108. in a new version.
  109.  
  110. ・Apparent least squares fitting errors that are due to singular matrices can now be
  111. solved with singular value decomposition methods.
  112.  
  113. ・ Plotting/Stats data list dialog would leave the last item selected twice...  gone.
  114.  
  115. ・ Minor memory bugs.  Major memory bugs.
  116.  
  117.  
  118.     Introduction:
  119.     ------------
  120.  
  121. Graf is object oriented in the way it handles data and plots. This means that each set of data has the 
  122. information on how it wants to be plotted, and each plot has its own formatting information and a 
  123. list of data to plot.
  124.  
  125. This is implemented through popup menus, thus Graf requires at least System version 6.0.2 to 
  126. operate. It will of course operate with all newer versions.   It is system 7.0 friendly, 32 bit clean
  127. and compatible with all macs from the mac plus up to the Quadra 950 and beyond. 
  128.  
  129. There are three kinds of windows in Graf. The first it the data windows, such as this one, then the 
  130. plot window type for graphs and finally the stat window for statistics.  Each kind of window
  131. has its own popup menubar to set up the various parameters needed for the final plotting.
  132.  
  133.     The data window menus:
  134.     ----------------------
  135.  
  136. ・ Marker: This menu allows the symbols and error bar styles to be set for the data points when 
  137. they are plotted. The current selection is shown on the menubar beside メMarkerモ. 
  138.  
  139. ・Symbols: This menu graphicly shows the available symbols.
  140. This menu is a 'tearoff' just like some hypercard menus. 
  141.  
  142. ・Size: This is the size of the enclosing box that the symbol is drawn in (the box is not drawn). The 
  143. メOtherノモ option uses the resource picture to show size changes graphicly. Note that when a high 
  144. resolution printer is used, the PICT format of symbol will automaticly take advantage of the higher 
  145. resolution and in general the symbols look best on the final output (where we want them to). 
  146.  
  147. ・Errors: Graf allows for independent +ニx, -ニx, +ニy and -ニy errors. The first 6 options are 
  148. various styles of errors, from none to ovals, the last two options are vector plot options, where 
  149. the ニx and ニy terms are not errors, but actually form a vector with the main data point. One 
  150. option has little arrow heads and the other is symmetrical about the data point and is bi directional.
  151. This menu is now a 'tearoff' just like some hypercard menus. 
  152.  
  153. ・Line: This menu specifies the way in which data points are joined. The current selection is shown 
  154. on the menubar beside メLineモ as a line in the selected style, and a small icon to show the joining 
  155. method. 
  156.  
  157. ・Pensize: is the thickness of the pen in point/pixels, On the screen widths less than one are 
  158. displayed as one. On high resolution printouts the actual thickness asked for is used. 
  159.  
  160. ・Pattern: shows the system list of patterns, to use in drawing the line. The 'plain' grays have 
  161. postscript grays substituted when printed, other bitmaps are copied. If you really want a different 
  162. pattern, then warm up ResEdit and make your own PAT# resource in Graf.... 
  163. This menu is now a 'tearoff' just like some hypercard menus.  It will grey out when the
  164. active window is not a data window.
  165.  
  166. ・Style: determines the methods of joining points, from a simple straight line to no line at all. The 
  167. rectilinear methods are useful for discrete, binned data where the value corresponds to the centre, 
  168. right or left edge of the bin. The smoothed option is a parametric quadratic bezier curve 
  169. using the data points  and as off curve controls and data point mid points as on curve controls.
  170. This menu isa 'tearoff' just like some hypercard menus.   It will grey out when the
  171. active window is not a data window.
  172.  
  173. ・Form Polygons: If this item is chosen, then the line segments will be grouped into macdraw style 
  174. polygons rather than simple groups. So, if you want a spline smoothing, then edit the plot with 
  175. macdraw, select the line and choose the smooth option...
  176.  
  177. ・Setup: This is where the x,y and error columns are assigned, and any scaling or offsets are 
  178. applied. Once the columns and offsets are determined (or defaulted) then these plus the Marker and 
  179. Line settings constitute a 'setup'. With multicolumn data, it is often desirable to plot several 
  180. different pieces of information,in different styles, so each data window actually has a list of 
  181. setups, starting with the initial 
  182. '1 of 1' . New, independent settings can be defined by adding new setups to the list with the little 
  183. arrows. the single arrows navigate up and down the list, adding new setups if needed. The double 
  184. arrow is used to reduce the total list of setups.  When a data window is plotted, it is actually 
  185. plotted a number of times, once for each setup in the list.
  186.  
  187. ・The 'Tabbed data' option refers to typical mac spreadsheet tab delimited data. Without this option 
  188. strings of tabs are regarded as as single column setting. When this options used then each tab 
  189. indicates a new column. This item is necessary for tabbed spreadsheets with missing entries in 
  190. some positions.
  191.  
  192. ・When 'Use Separators' option is used, Graf assumes that when a text line (ie not a number line)
  193. is encountered, the current curve ends and a new one is started when the next numbers are 
  194. found. ie
  195.  
  196.         0.1    0.1
  197.         0.2    0.2
  198. c
  199. c coments, anything really
  200. c
  201.         0.3    0.3
  202.         0.4    0.4
  203.  
  204. would be plotted as one continuous curve normally, and as two separate ones when 'Use Separators'
  205. are used.
  206.  
  207. ・Text: The data windows are text files, and behave like a very simple word processor (hence this 
  208. document). So each data has a Text menus for changing the appearance of the data only, this has no 
  209. effect on the plotting operations at all.
  210.  
  211. The data in the data windows is organised as follows:
  212.  
  213. ・The data is in a 'free form' text style, unlike the more common cell or spreadsheet style. This has 
  214. a number of advantages and disadvantages: 
  215. ・The best advantage is that virtually any TEXT document can be read in a view in a readable and 
  216. sensible manner. Special column separators and so on are *not* needed. 
  217. ・The worst disadvantage is that manipulating columns of data is very difficult. Graf is NOT an 
  218. analysis program, and any spreadsheet like fiddling should be done before entering Graf. A 
  219. Multifinder setup with excel and Graf works very well, with Graf providing the high quality 
  220. graphics that Excel lacks. 
  221. ・ The data is still conceptually organised in columns, with the columns being defined on a line by 
  222. line basis. That is, columns only exist on lines that have columns of numbers, and any line can have 
  223. any number of columns from 0 up. 
  224. ・ Graf uses a fairly clever interpreter to get the information from the data. This means that 
  225. enormous data arrays are not needed, in fact only 6 binary numbers are needed (x,y,+ニx,-
  226. ニx,+ニy,-ニy) at any one time. It has also been introduced to the output from various makes of 
  227. computers and can handle data with line feeds or without for example. 
  228. ・ The following is a conceptual description of how Graf reads the data files:
  229.  
  230.     i) Check the first non-space character on a line,Column counter = 0, 
  231.     ii) If it is a numerical character then goto 4 
  232.     iii) Skip line and goto 1 
  233.     iv) increment column counter 
  234.     v) Read in characters until a non-numerical character or newline is encountered 
  235.     vi) Form a number with the characters so far.The numbers that correspond to your column
  236.     settings are plotted and the rest are skipped. 
  237.     vii) read more characters, goto 2. 
  238.     {this is VERY conceptual} 
  239.  
  240. ・Put Simply: any line that doesn't begin with a number is skipped. Columns of numbers may be 
  241. separated by *any* non numerical characters(including tabs). Columns are read along a line until
  242. the line runs out or the  required columns have been read. Any time a required number fails
  243. to evaluate (ie a malformed number or  missing columns, a value of zero is used, mostly so
  244. the problem is visible and corrections can be applied).
  245. ・Individual window may only contain 1 GigaByte of  characters. If a larger data file is read, Graf
  246. will crash! :-) Ha Ha!
  247.  
  248.     The plot windows menus:
  249.     -----------------------
  250.  
  251. ・ The most important menu in the plot window is the メData setsモ menu. This is a dynamic, changing 
  252. menu that shows the list of available data to plot. By selecting data window with this menu, the plot 
  253. window accumulates the list of data to plot. When the draw button is pressed, this list is processes 
  254. sequentially, in the order they were selected. If a data window consists of a series of setups the 
  255. these are cycled through before the next data is processed. Each data set is plotted in the style 
  256. defined in the manner defined in their respective setups in their respective windows. 
  257. ・ The first item selects a dialog box that has all the data sets in a list.  You can select
  258. multiple sets at one go.
  259.  
  260. ・Axes: this menu defines the basic appearance of the plot. 
  261.  
  262. ・Size refers to the size of the rectangular frame that the plot is drawn in. The dialog box that come 
  263. up is designed to work in pixels as this is the only way to be sure of the final result. There are x2 
  264. and /2 buttons for scaling up and down easily, useful for when you want to print at some sort of 
  265. reduction on your printer. 
  266. ・ Ticks: Tick spacing are in terms of the data units, tick lengths are in pixels. The Autoscale button 
  267. provides 'semi-automatic' scalings of ticks to the current range. A warning will appear if you 
  268. choose a ticks spacing that will produce hundreds of ticks, either redo the spacing or use the auto 
  269. scale option. 
  270. ・Range: determines the data values that will be plotted. Data points outside this range will not be 
  271. plotted.  If all points fall out of range during a plot then a warning is given.
  272. ・Scales: This is where you can choose normal, log-normal and log-log plotting, to various bases. 
  273. The data is メloggedモ and the plotted on normal linear axis, there are no silly uneven spaced ticks. 
  274. ・Numbers etc: This section of the Axes menu determines the setting for the axes numbers!
  275. ・Labels:This menu is the implementation of labelling in Graf. It provides for a title, x-axis label and 
  276. y axis rotated label. In addition a legend facility is available. For more fancy labelling, save the plot 
  277. and post edit it with a program like macdraw. 
  278. ・Thickness: is the thickness of theframe and ticks in point/pixels, On the screen widths less than
  279. one are displayed as one. On high resolution printouts the actual thickness asked for is used. 
  280.  
  281. Each submenu give independent control over the content and style of each label. The dialog boxes 
  282. ask for a string (up to 40 chars) and a location (in pixels) for the label. The labels are centered on 
  283. the location The labels can be drawn or not drawn, and have an optional frame. 
  284.  
  285. The names used in the legend come from the columns setup for the data sets.  The lines/marker 
  286. styles are read from the data setups.
  287.  
  288. ・ Special: This menu contains a group of miscellaneous items. 
  289. ・ Previewノ: This item brings up a small floating winowoid that displays the current plot and the
  290. number of pages needed to print it using the current page setup.  As the plot size and/or pagesetup
  291. change this window will resize to reflect the page layout.  It will not grow too large however and 
  292. should always remain a relatively small proportion of a 9" Mac screen in size.  You cannot 
  293. manipulate the plot layout with the windoid. (Yet!)
  294.  
  295. ・Overlays: this is a list of plot windows. This list is drawn in the current plot window before the 
  296. current plot is drawn. In this way multiple plots can be layed out on one page. In addition, Graf can 
  297. read any PICT file into a plot window, so some fancy background pictures could be used for your 
  298. plots.
  299.  
  300. ・The Draw button: In general, drawing the data is a slow business, compared to the frame and axes 
  301. etc. So While all the plot formatting is redrawn automaticly, no data is plotted until the button is 
  302. pressed.  When there are few data points, this is no problem, and when there are many, it is much 
  303. easier to get everything just right and then plot the data last. 
  304.  
  305. The data plotting can be interrupted on a set by set basis. That is 'command - .' will stop the 
  306. current set being plotted, and the next set if any will be commenced. For a single set this will then 
  307. stop the plotting and for multiple sets, multiple interrupts may be needed. This was done to allow 
  308. finer control over the interruptions, particularly is you want to skip forward over sets to have a 
  309. look at how a later set will look. 
  310. During plotting, the data window being plotted is displayed in the bottom left 'information' box in 
  311. the plot window. A percentage shows how much of the file has been read (not how many data 
  312. points), in ten line  steps. With multiple setups, one file name will be shown with the setup counters 
  313. incrementing several times.
  314.  
  315. ・The Auto button: Same as draw, with a prior scan to set the ranges and ticks.
  316.  
  317.     Graphical plot manipulation:
  318.     -------------------------
  319.  
  320. Frame:
  321. ・A single-click-drag in the plot frame allows the user to reposition the frame, the frame etc will 
  322. be redrawn, but not the data. 
  323. ・A double-click in the frame will bring up the size dialog. 
  324. ・The bottom right corner of the frame is a resizing corner for clicking and dragging. Labels & 
  325. Legend: 
  326. ・A single-click-drag in the labels allows the labels to be relocated. In a layered system, the labels 
  327. are on top of the data and frame. 
  328. ・A double-click in a label will bring up the appropriate dialog. Ticks: 
  329. ・A double-click in the lower x axis ticks or left y axis ticks will bring up the range dialog. 
  330. ・A option-double-click in the lower x axis ticks or left y axis ticks will bring up the ticks dialog.
  331.  
  332. Numbers:
  333. ・A double-click in the numbers will bring up the numbers dialog.
  334.  
  335.     Label Styled Text.
  336.     -----------------
  337.  
  338. Text for lables and the legend (via the data columns dialog) can be styled.  It is a plain
  339. text formatting method similar to Word formulas and TeX.
  340. Here is a summary.  'Arg' stands for any expression, including other fomat statements,
  341. from one character up to whole expressions. Examples here can be cut and pasted into
  342. a plot title dialog to see how they look.
  343.  
  344. {Arg1 Arg2}        Curly braces group many Args into one Arg
  345.             Formats such as italics are contained within the 
  346.             braces, this is a good way to stop italics from breaking out.
  347.             Example: See below.
  348.  
  349. ¥-            Plain text, stops all other settings.
  350.             Example: {¥! Tex¥-t} will make the first three lettes in italics
  351.             and the last in plain text.
  352.  
  353. ¥!            Italic text.
  354.             Example: Hello {¥! everyone}  eveywhere!
  355.             will make the first and last words plain letters, and 'everyone' in italics.
  356.  
  357. ¥@            Bold text.
  358.             Example: I'm so  {¥@ FAT}!
  359.             will make the first words plain letters, and 'FAT' in bold.
  360.  
  361. ¥&            Bold & Italic text.
  362.             Example: I'm so  {¥& indecisive}!
  363.             will make the first words plain letters, and 'indecisive' in bold-italic.
  364.  
  365. ¥$            Symbol Characters
  366.             Example: {¥$ abg}
  367.             will show as alpha beta gamma. Useful in H{¥$a} for hydrogen
  368.             spectra.
  369.  
  370. ¥^            Super Script next arg  
  371.             x¥^2
  372.             will make x squared.  May look better as {¥!x¥^2}
  373.  
  374. ¥^            Sub Script
  375.             Example: H{¥_2}0 will make the water molecule.
  376.             Example: A{¥_long superscript}
  377.  
  378. ¥、{arg}{arg}         Super Sub Script the next two args are used as simultaneous super
  379.             and sub scripts. 
  380.             Example: SO{¥、{2+}{4}}
  381.  
  382. ¥¥             Backslash, since ¥ is used for the other commands
  383.  
  384. ¥}            Right Bracket, since } is used for grouping
  385.  
  386. ¥{            Left Bracket, since } is used for grouping
  387.  
  388.  
  389.     The Stat windows menus:
  390.     -----------------------
  391.  
  392. ・ The most important menu in the stat window is the メData setsモ menu. This exactly equivalent
  393. to the data sets menu in plot windows, see above.
  394. ・ The first item selects a dialog box that has all the data sets in a list.  You can select
  395. multiple sets at one go.
  396.  
  397.     General Notes:
  398.     -------------
  399.  
  400. The fine lines in Graf do not require page reduction for printing, a good result will come from 100% 
  401. page sizes. If you are attempting to make multiple line segments look smooth however, consider 
  402. drawing a large plot and reducing the printout, this reduces the quickdraw integer coordinate 
  403. rounding errors which depend on the resolution that the plot is drawn at. That is if you have 2000 
  404. pixels to choose from compared to 200 ,say, the a better accuracy will be achieved.
  405.  
  406. Graf knows what resolution the printer is using, so you do not have to use the precision bitmap 4% 
  407. reduction etc, and a 25% reduction really maps to 300 dpi on the laserwriter. The page breaks for 
  408. the plot, using the current page setup are drawn in 3 pixel wide stripped lines, these lines are NOT 
  409. printed. These lines are centred on the page break.
  410.  
  411. The normal menubar menus are standard menus, plus a Data window to display data windows, and a 
  412. plot menu for finding plot windows. The メHideモ file option simply makes the window invisible, the 
  413. window still exists and can be plotted etc, the appropriate menu will redisplay the windows.
  414.  
  415. In principle there are no limits to the number of windows, size of data or plots etc in Graf, however 
  416. the current version will only handle upto ~256 windows and 100 column data and any number of 
  417. setups! This is all limited by your available memory, but graf will work in ~544K of RAM with 10 
  418. or so windows. Check the aboutノ item for your current free memory. If you get low on memory 
  419. then you will be given the opportunity to save your work and quit. Try the usual methods to 
  420. increase your RAM available for the program if this happens.
  421.  
  422.     General Setup:
  423.     --------------
  424.  
  425. Default settings can be defined by setting up a window in the desired format and saving it under a 
  426. special name. For default text settings name the file 'Default Text' (case is important), and use 
  427. 'Default Plot' for a default plot setting. When new blank windows are required, Graf will look for 
  428. these files in the same directory as Graf, and in the system folder. If they are found then they will 
  429. be loaded in as Untitled-x or Plot-x (where x is a number). If they are not found then internal 
  430. defaults are used.
  431.  
  432. The Preferences menu item 'Auto draw plots' is the same as using the draw button all the time. This 
  433. is only really useful for small data sets when drawing is quick.
  434.  
  435. The Show Floats item will only be available once a floating palette/menu has been torn off. The 
  436. show /hide operations will only apply to the currently 'torn' menus.
  437.  
  438.  
  439.     Questions, Suggestions and Bugs to (in 1995):
  440.     ---------------------------------
  441.  
  442.         Ralph S. Sutherland. 
  443.         JILA
  444.         University of Colorado
  445.         Boulder, CO, 80309-0440
  446.         USA
  447.  
  448.     email:
  449.  
  450.         ralph@madras.anu.edu.au
  451.         ralph@zwicky.colorado.edu 
  452.  
  453. Cheers
  454.  
  455. Ralph   (Feb 1994)
  456.  
  457.  
  458. PS    Complete Version History 
  459.     -----------------------
  460.  
  461.  
  462.     v2.1.2 - 2.3.3
  463.     --------------------
  464.  
  465. ・ Experimental versions, not released.
  466.  
  467.  
  468.     New for 2.1.1:
  469.     ------------
  470.  
  471. ・ One bug fix: stops crash when selecting a plot window when data window palletes
  472. are showing!!   This is such a bad bug that a new version was needed immediately.
  473. Don't use v2.1.0
  474.  
  475.     New for 2.1.0
  476.     -------------
  477.  
  478. bug fixes:
  479. ・ Worked around a persistent crash when opening files in 32 bit mode.  No icons in lower list
  480. until a fix is worked out.
  481. ・ Added Startup Splash-Screen
  482. ・ Improved scroll bar updates (as usual :-) )
  483. ・ Added some new quit options  'Quit and save all' and 'Quit and don't save'.
  484. These are*Really* useful when you have about 40 files open and can save a lot 
  485. of time.  But be careful with the don't save option.
  486. ・ Improved the columns setup dialog to allow the user to switch through all the 
  487. current setups of all the windows using a popup menu.
  488.  
  489.     New for 2.0.5-9
  490.     ---------------
  491.  
  492. ・ Mysterious Hiatus that will go undocumented.
  493.  
  494.     New for 2.0.4
  495.     -------------
  496. minor bug fixes:
  497. ・ Fixed cursor keys for data and stat windows
  498. ・ Simplified About dialog
  499. ・ Fixed editing crash during low memory conditions.
  500. ・ Font menus now act as advertised below.  There is only one menu in the resources now.
  501. you can modify it as you please with ResEdit to show your own favorite set of fonts.
  502. Graf 2 will automatically disable unavailable fonts.  All the font menus in the program will
  503. be the same as the single resource copy.
  504. ・ Sounds now default off.
  505. ・ Slightly changed menu click areas on window menubars to include symbol disply areas
  506. as well as drop boxes and text.
  507. ・  Fixed plot preview.
  508. ・ 'Auto plot' should now cause plots to erase properly before replotting.
  509.  
  510.     New for 2.0.1, 2, 3
  511.     -----------------
  512.  
  513. minor bug fixes:
  514. ・ハData list selection bug *really* fixed.
  515. ・ハData list selection buttons work.
  516. ・  v1.4.3 plots with Y lables load correctly.
  517. ・ハText menu in stat windows fixed.
  518. ・ハFiddled with scrollbar adjustment.
  519. ・  Slight change in parsers to correctly ignore lines with leading spaces and no numbers.
  520. ・ハFixed test size display updates.
  521.  
  522. Remaining features:
  523. ・ Arrow keys don't work
  524.  
  525.     New for 2.0: Major version upgrade
  526.     --------------------------------
  527.  
  528. General:
  529.  
  530. ・ All visible text and words in menus and information areas are  stored as string
  531. resources so that localization to other languages is conceivable.
  532. ・ Whizzy new colour menubars in windows.   Color coded:  data - red, plot - blue, 
  533. and new statistic windows use green.
  534. ・ Most modal dialog boxes can be dragged around under system 7.x
  535. ・ Active window is checked on the main menubar wind list menus.
  536. ・ Sounds can be turned off when they are too annoying.
  537. ・ Completely new statistics and line fitting capabilities using new 'stat' windows that
  538. are similar to plot and data windows.  More details below.
  539. ・ Undo
  540. ・ Floating windows no longer keep disappearing when other windows are selected.
  541. inappropriate floating windows are simply grayed out when they don't apply to 
  542. the active window.
  543. ・ Background processing improved.
  544. ・ New finder icons, you may need to rebuild your desktop to see them though.
  545. ・ The font menus is organised by typeface type, ie mono-spaced, serif, sans-serif and fancy.  
  546. ・ The menu is predetermined and may be edited with ResEdit if you have a different favorite set. 
  547. Any font on the menu that is not found at startup is simply greyed out.  Having the predetermined
  548. typeface sets greatly speeds up startup on machines with many fonts installed.
  549. ・ New styled text, such as super and subscripts is implemented for plots and display text
  550. in general.
  551. ・ A set of example files, data, stats and plots are given to show the neat features of Graf.
  552.  
  553. Data Windows:
  554. ・ New text editing library, the programmers editors package v1.0, allows the
  555. editing of large data files.  No more load headers, you can edit a multi-megabyte
  556. file if you have the RAM.
  557. ・ Undo allowed in text editing.  Can be disabled when memory is low.
  558. ・ Tabs are supported in the new text editing, can make data files look a lot better. (see below)
  559. ・ Multiple data sets in one data window are possible, any non numerical line
  560. breaks the plotting and starts a new curve.  See examples.
  561.  
  562. Plot Windows:
  563. ・ New data set selection mechanism using a list dialog is available to make selecting
  564. multiple data sets to plot *much* easier.
  565. ・ Automatic range setting with a new button.  The Auto button first scans the data sets to
  566. chose an appropriate range and domain to plot, sets the ranges and ticks, and then does a 
  567. normal plot.  This is somewhat slower than a normal plot, but it can be a real timesaver
  568. if used once, followed by normal draw commands.
  569. ・ A resolution option for the y-axis label allows high resolution printing of the 
  570. y-axis lable on non-postscript printers.
  571. ・ Title, axis and legend text can be formatted to have super/subscripts etc.  A format
  572. button in the label/title dialogs shows the possibilities. See also the new example files.
  573. ・  Progress display is different, neater and nicer.  (IMHO)
  574. ・ハProgress is faster.
  575. ・  Double Click algorithm changed.
  576. ・  Page placement of plot can also be manipulated by dragging the reduced view in the 
  577. plot preview window.
  578. ・ Numbers can be placed on any, all or no axis. See numbers dialog.
  579. ・ logs of negative number magnitudes may be taken using the log(|x|) option in the 
  580. scales dialog.
  581. ・ The plot frame may be omitted, using the size dialog.  This is useful for curves that are
  582. going to be overlayed.
  583.  
  584.  
  585. Stat Windows:
  586. ・ハAll new :-)
  587. ・  Simple statistics.  On direct and log transformed data
  588. ・  Unweighted, Experimental errors, Gaussian weight and Poissonian weights.
  589. ・  Linear and polynomial regression fitting.  Up to 6th order fits, beyond that
  590. it stops being physically realistic.
  591. ・  A cubic spline fitting routine is available.  This need monotonic x data.
  592. Thanks to Roland Kjellander for the algorithm.
  593. ・  Some unfinished routines are disabled.
  594. ・ There are a number of result output options.
  595. ・ハResults can be pasted into a plot window and plotted, or saved as a stat
  596. or a text file.
  597. ・ A calculate button, analagous to the plot draw button, starts the calculations.
  598. ・ Data set selecton is the same as in plot windows.
  599.  
  600. Bug Fixes [well, just the biggest ones:-) ]
  601.  
  602. ・ The funny double shuffle (maybe that was only in 1.5.8) when closing windows is gone.
  603. ・ The intermittent crash when closing many data windows is gone, really.
  604. ・ Other memory problems, some of which may have been related to pre-crash
  605. conditions from the data closing crash, appear to be fixed.
  606. ・ Low memory recovery is more robust.
  607. ・ Misc Cosmetic bugs fixed.
  608.  
  609.     New for 1.5.8
  610.     -------------
  611.  
  612. The dark years....1993-1994  There were more bugs than features in version 1.5.8.  I'd rather
  613. not talk about it.
  614.  
  615.     New for 1.4.2/1.4.3
  616.     -------------------
  617.  
  618. ・ System 7.0 Publish and Subscribe!  Allows for publication of plots and subscription of
  619. data.  By combining Auto redraw for plots and a new auto publish options, Graf can serve as
  620. a plotting facility to any program that can publish and subscribe.
  621. ・ Enabled the colour option for the marker symbols at last.  (They used to be stuck as black)
  622. ・ Resolved design problems with 'Header' data windows. The file name is nolonger suffixed
  623. with the '-Header' text.  The info box now displays tiny status icons that differentiate the Header
  624. files from normal data files.  This fixes problems with file names on disk.
  625. ・ Can operate in the background.  This is useful for publish/subscribe server setting and for
  626. future releases of Graf with Apple Event control.
  627. ・ Standardised the dialog button locations to suit the system 7.0 user interface guidelines.
  628. ・ New smoothing algorithm based on bezier curves to give a truely parametric smoothing.  This
  629. means that you can smooth a spiral if you really want to.
  630. ・ Faster columns allocation dialog, you can now jump forward and back by 6 columns at a time
  631. by clicking in the numbers part of the 'scrollbar'.  The click sound has been removed as well.
  632. ・ Plot page preview windoid.  Useful for Macs with small screens, this will reduce the need
  633. for scrolling around to check the page layout for big plots.
  634. ・ Changed Default Text and Defaul Plot mechanism.  You now need to place the default files
  635. in the system folder on the startup disk.  The preferences folder is not used to maintain System 6
  636. compatibility without undue coding complications.
  637. ・ Reorganised plot window menus. Overlays is now a submenu of a 'Special' menu which 
  638. includes the new page preview option.
  639. ・ Added cooler colour buttons/icons etc for those with colour macs.
  640. ・ Improved tearoff menus so that they don't tear off so easily.
  641. ・ Upgraded the line style menus to bring it in line with the style of the other tearoffs.
  642. ・ Fixed bug where last byte in data file was ignored (Thanks John)
  643. ・ Fixed colour menu so that the colour items remain coloured.
  644. ・ Finally fixed text scrolling (Applause!).
  645. ・ Many minor bug fixes, to numerous to mention (well, this is freeware)
  646.  
  647.     New for 1.3.1/1.3.2
  648.     -------------------
  649.  
  650. ・ Figured out 68000 mac  (Plus, SE etc) QuickDraw bug work around.  
  651. Stops crash on startup when using a default plot.  I should never have sold my mac plus....
  652. ・ Also for 68000 mac owners, speed up in text input.
  653. ・ Fixed crash upon quitting without saving any modified files
  654.  
  655.     >>>>>>>>>IMPORTANT: New for 1.3.0<<<<<<<<<<
  656.     --------------------------------------------
  657.  
  658. ・ Fixed a bug when saving large files (ie Header windows) that would otherwise cause all
  659. but the first 28k to be missing from the saved file.  This may cause data to be lost.  Please
  660. stop using ANY version before 1.3.0.
  661. ・ Fixed a bug caused by cosmetic plotting bug fixes....□□□□ (see v1.2.6)
  662.  
  663. {Stuff about eariler versions deleted}
  664.  
  665.  
  666.